home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / mntdoc01.zoo / mintdoc / cat2 / fpipe.nr < prev    next >
Encoding:
Text File  |  1993-03-03  |  1.4 KB  |  67 lines

  1.  
  2.  
  3.  
  4. Fpipe(2)                   Oct. 1, 1991                  Fpipe(2)
  5.  
  6.  
  7. N✓NA✓AM✓ME✓E
  8.        Fpipe - create a pipe
  9.  
  10. S✓SY✓YN✓NO✓OP✓PS✓SI✓IS✓S
  11.        LONG Fpipe( WORD usrh[2] );
  12.  
  13. D✓DE✓ES✓SC✓CR✓RI✓IP✓PT✓TI✓IO✓ON✓N
  14.        _✓F_✓p_✓i_✓p_✓e  creates  a  pipe  that may be used for interprocess
  15.        communication. If it is successful, two GEMDOS handles are
  16.        returned  in  usrh[0]  and usrh[1]. usrh[0] will contain a
  17.        handle for the read end of the pipe, (opened  for  reading
  18.        only), and usrh[1] will contain a handle for the write end
  19.        of the pipe (opened for writing only).
  20.  
  21.        The created pipe has the name "sys$pipe.xxx", where  "xxx"
  22.        is a three digit integer.
  23.  
  24. U✓US✓SA✓AG✓GE✓E
  25.        Typically used by shells; the shell redirects its standard
  26.        input (or standard output) to the read (or write)  end  of
  27.        the  pipe  using _✓F_✓d_✓u_✓p and _✓F_✓f_✓o_✓r_✓c_✓e before launching a child;
  28.        the child will then read from (or write to)  the  pipe  by
  29.        default.
  30.  
  31. R✓RE✓ET✓TU✓UR✓RN✓NS✓S
  32.        0 if successful
  33.  
  34.        ENHNDL if there are not 2 free handles to allocate for the
  35.        pipe
  36.  
  37.        ENSMEM if there is not enough free memory  to  create  the
  38.        pipe
  39.  
  40.        EACCDN if too many pipes already exist in the system
  41.  
  42. B✓BU✓UG✓GS✓S
  43.        There  cannot be more than 999 open pipes in the system at
  44.        one time.
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64. Version 0.9          MiNT Programmer's Manual                   1
  65.  
  66.  
  67.